Infinite Menus, Enterprise Edition

Required Class Files: ime.class, imerend.class
Notice Tag: "Infinite Menus, Enterprise Edition, Copyright (c) 1997 OpenCube Technologies, Registered (Unique Key ID#)"

The Required Parameters:

Parameter 1, the notice tag, must be included in the applet tag in order for the applet to work. The only other required parameters are at least one image file name and highlight image file name. Usually the easiest way to customize your applet is to cut and paste the applet tag used in the sample and modify it to fit your web page

Defining Colors:

This applet uses a simple RGB or Hexadecimal color definition scheme. On most systems (depending on the software being used to choose a color) its easier to define a color using RGB, however since most web pages define colors using a HEX value we have allowed for both methods of color definition. To define a color using RGB use commas to separate the values such as 255,255,255 (White). To define a color using a hexadecimal value use a pound sign ('#') followed by a 6 digit hex value in the rage of 000000 - FFFFFF (e.g. #FFFFFF is equal to the color White).

Color Definition with RGB: To define a color in one of the color parameters using RGB choose a value between 0 - 255 for the red, green, and blue components separated by commas and typed out in the correct r,g,b order. Below is a sample of how a color parameter using RGB should look, the example specifies several different sample colors for the "bgcolor" parameter.

WHITE: <param name="bgcolor" value="255,255,255">
GREEN: <param name="bgcolor" value="0,255,0">
BLACK: <param name="bgcolor" value="0,0,0">
YELLOW: <param name="bgcolor" value="255,255,0">
OFF WHITE: <param name="bgcolor" value="240,239,234">

The best way to choose the exact color you are looking for without having to guess the numbers is to access your systems Color Picker. Color Pickers usually allow you to drag the mouse over a rainbow type color grid to select a color, and show you the appropriate RGB values. In windows the Color Picker is accessible through MS Paint as well as a majority of the popular Imaging and HTML Authoring Software.

Defining Multiple attributes with One Parameter:

Parameters used to customize a specific image location or message are indicated using a range, such as "imagefile0" - "imagefileN". To define a parameter for a specific image or message (available when noted as above), use "imagefile0" to define, in this case, the first main menu image, "imagefile1" would define the second main menu image, etc.

The Applet Coordinate System:

The origin of the applets coordinate system is located at the upper left corner of the applet. The x (horizontal) coordinate starts at the left border with 0 and go as far to the right as the applet is wide (defined with the width tag - see above). The y (vertical) coordinate starts at the top of the applet with 0 and go down as far as the applet is high (defined with the height tag - see above).

The Applet Parameters

The Applet

Parameter 1
Attribute: Copyright notice.
param name="Notice"
value="Infinite Menus, Enterprise Edition, Copyright (c) 1997 OpenCube Technologies, Registered (Unique Key ID#)"
Note: This must be included for the applet to work.

Parameter 2
Attribute: Applet Background Color
param name = "bgcolor"
Value = R,G,B, Where R,G,B are the red, green, and blue components of the applets background color.

Parameter 3
Attribute: Default Status Bar Text when mouse is over applet
param name = "onsbtext"
value="X", where X is the message to appear in the status bar when the mouse is over the applet but not over a URL link.
DEFAULT: OpenCube - Infinite Menus Menu

Parameter 4
Attribute: Default Status Bar Text when mouse is off applet
param name = "offsbtext"
value="X", where X is the message to appear in the status bar when the mouse is not over the applet.
DEFAULT: Java by OpenCube

The Background Image

Parameter 5
Attribute: Background Image File Name
param name = "bgimagefile"
Value = X. Where X is the relative location and name of the image file to be displayed in the applets background, Note: Transparent images will appear correct over the background images.

Parameter 6
Attribute: Background Image X Location
param name = "bgimagex"
Value = X. Where X is the horizontal coordinate location to display the background image at, relative to left border of the applet area.
DEFAULT: 0

Parameter 7
Attribute: Background Image Y Location
param name = "bgimagey"
Value = X. Where X is the vertical coordinate location to display the background image at, relative to top border of the applet area.
DEFAULT: 0

The Images

Parameter 8
Attribute: Image File Locations and Names
param name = "imagefile0" - "imagefileN"
Value = X. Where X is the relative location and name of the image file to be displayed in the applet area as a main menu image. This must be defined relative to the location of the HTML document which contains the applet.

Parameter 9
Attribute: Image x (horizontal) locations
param name = "picx0" - "picxN"
Value = X. Where X is the horizontal location of the left border of the image relative to the left margin of the applet. If your applet width is defined as 100, picx="50" would place the left border of the image horizontally dead center.

Parameter 10
Attribute: Image y (vertical) locations
param name = "picy0" - "picyN"
Value = X. Where X is the vertical location of the top border of the image relative to the top of the applet.

The Highlighted Images

Note: The images defined as Highlight images appear as the mouse moves over a main menu image. The highlighted images are automatically placed directly over the main menu image to which they correspond and therefore should have the same dimensions as the main menu image to which they belong.

Parameter 11
Attribute: Image File Locations and Names
param name = "switchfile0" - "switchfileN"
Value = X. Where X is the relative location and name of the image file to be displayed in the applet area when the mouse is over a main menu image. This must be defined relative to the location of the HTML document which contains the applet.

The Associated Sub Menus Descriptions

Parameter 12
Attribute: Sub Menu Descriptions
param name = "desc0-0-0..." - "descN-N-N..."
Value = X, Where X is the message that corresponds to the index used to identify an image as well as its parent sub menu if applicable. To define level 1 sub menus (the first menu to appear as the mouse moves over an image) use "descN-N", e.g. "desc0-0" refers to the first sub menu description for the first image, "desc0-1" refers to the second sub menu description for the first image. To branch another sub menu of a previous sub menu extend the reference, e.g. "desc0-1-0" would force a new menu to pop up as the mouse passed over the second description in the first sub menu defined by "desc0-1", "desc0-1-1" would add another description to this new second level sub menu. Sub menus may be branched indefinitely in any configuration.

Parameter 13
Attribute: Font
param name = "font"
Value = X. Where X is the name of the font to be used for all sub menu messages. (valid Java font names: "Courier", "Helvetica", "TimesRoman", "Dialog", "DialogInput")
DEFAULT: Helvetica

Parameter 14
Attribute: Font Size
param name = "size"
Value = X. Where X is font size of the font for all sub menu messages.
DEFAULT: 12

Parameter 15
Attribute: Font Style
param name="fontstyle0" - "fontstyleN"
value= bold, italic, bolditalic, plain
DEFAULT: plain

Parameter 16
Attribute: Default Text Color
param name = "menutextcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Black

Parameter 17
Attribute: Left and Right Margins
param name = "lrmargin"
Value = X, Where X is the left and right margin to use for the sub menu messages.
DEFAULT: 4

Parameter 18
Attribute: Center or Left Justify Text?
param name = "centertext"
Value = true or false, True = yes, Center Text - False = no, left justify text
DEFAULT: Left Justified

Positioning the Sub Menus

Note: To specify the placement of a given sub menu point to the sub menus base index value, e.g. "menuxoffset1-2" would refer to the sub menu defined for the third menu description for the second images initial sub menu, "mainxoffset1-2-0" would refer to the first sub menu of the sub menu associated with the third menu description for the second image, "mainxoffset2" would refer to the third images initial sub menu. See the "descN-N-N" tag for more information. If the menu is an initial sub menu of an image the values described below are offsets from the top left corner of the image, if the menus is a sub menu of a sub menu the values described below are offsets from the top left corner of the sub menus parent sub menu. To specify placement above or to the left of the parent image or sub menu use a negative value with the parameters below.

Parameter 19
Attribute: Sub Menu X (Horizontal) Offset from the left side of the Image or Sub Menu
param name = "menuxoffset0-0..." - "menuxoffsetN-N..."
Value = X, Where X is the x offset from the left edge of the image or sub menu using the coordinate system described above. A value of 0 would place the sub menu's left border at the left edge of the image or at the left edge of its parent sub menu.
DEFAULT: 15

Parameter 20
Attribute: Sub Menu Y (Vertical) Offset from the top of the Image or Sub Menu
param name = "menuyoffset0-0..." - "menuyoffsetN-N..."
Value = X, Where X is the y offset from the top of the image or sub menu using the coordinate system described above. A value of 0 would place the sub menu's top border at the top edge of the image or at the top edge of its parent sub menu.
DEFAULT: 15

Customizing Sub Menu Colors

Note: The index N for a specific color property identifies a sub menu level, all the sub menus on the level inherit the property of the parameter used with N. A sub menu level must exist (defined using the "descN-N-N..." tag) in order to define a property for it. The second sub menu level (a sub menu branched off from a main menu images sub menu) starts with the number 0. To define a property for the second level menus use "menutextcolor0", to define a text color for the third level menus use "menutextcolor1", etc. Level definitions cannot be skipped, in other words to define a property for the third sub menu level you must also define a property for the second sub menu level. What happened to the first level sub menus? The first level sub menus are defined using the default parameters (a parameter with no index, e.g. "menutextcolor").

Note: It is not actually necessary to sequentially define all specific level color properties, so long as at least one of the parameters is specifically defined for each level and is equal to or greater then any of the other level parameters non sequential index specifications. For example, say you have 4 levels of sub menus and you want to specifically define a menu color for each level, however you want to use the same text color on each level except for the fourth level. To do this you must define each levels menu color first. The level one menu color would be defined using "menucolor", level 2 using "menucolor0", level 3 using "menucolor1", and level 4 using "menucolor2". Since you have sequentially defined all your levels using the "menucolor" you are free to skip around with any other level parameters. This means that defining the text color for level 4 only requires one "menutextcolor2" tag.

Parameter 21
Attribute: Default Sub Menu Background Color
param name = "menucolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Yellow

Parameter 22
Attribute: Specific Sub Menu Background Color
param name = "menucolor0" - "menucolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Parameter 23
Attribute: Default Text Color
param name = "menutextcolor0" - "menutextcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Black

Parameter 24
Attribute: Specific Text Color
param name = "menutextcolor0" - "menutextcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Parameter 25
Attribute: Default Sub Menu Outline Color
param name = "menuoutlinecolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Black

Parameter 26
Attribute: Specific Sub Menu Outline Color
param name = "menuoutlinecolor0" - "menuoutlinecolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Parameter 27
Attribute: Default Sub Menu Highlight Background Color
param name = "menuhlcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Red

Parameter 28
Attribute: Specific Sub Menu Highlight Background Color
param name = "menuhlcolor0" - "menuhlcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Parameter 29
Attribute: Default Sub Menu Highlight Text Color
param name = "menuhltextcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Black

Parameter 30
Attribute: Default Sub Menu Highlight Text Color
param name = "menuhltextcolor0" - "menuhltextcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

URL Links

Parameter 31
Attribute: Image URL Links
param name = "imagedesturl0" - "imagedesturlN"
value=X, where X is the link for the specific image. URL's can be defined relative to the HTML document containing the applet or fully qualified.

Parameter 32
Attribute: Specific Load Destination Image URL Where?
param name="imageloadwhere0" - "imageloadwhereN"
The "loadwhere" tag specifies where the document specified in the "imagedesturlN" tag should be loaded. The default is "_self"

"_self" show in the current frame
"_parent" show in the parent frame
"_top" show in the top-most frame
"_blank" show in a new unnamed top-level window
"name" show in a new top-level window named name

Parameter 33
Attribute: Sub Menu URL Links
param name = "desturl0-0-0..." - "desturlN-N-N..."
value=X, where X is the link for the specific sub menu message. (e.g. to define a link for the first images first sub menu message use "desturl0-0" for the second use "desturl0-1", to define a link for the first sub menu message which is related to the first images initial sub menus second description use "desturl0-1-0", etc. For more information regarding this process see the "descN-N-N..." parameter. URL's can be defined relative to the HTML document containing the applet or fully qualified.

Parameter 34
Attribute: Default Load Destination URL Where?
param name = "loadwhere0-0-0..." - "loadwhereN-N-N..."
The "loadwhere" tag specifies where the document specified in the "desturlN-N-N..." tag should be loaded. The default is "_self"

"_self" show in the current frame
"_parent" show in the parent frame
"_top" show in the top-most frame
"_blank" show in a new unnamed top-level window
"name" show in a new top-level window named name